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JAVA C++ PROXY OBJECTS 

Field of the Invention 

The invention relates to programming language interactions, and more 
specifically to legacy C++ GUI interactions with a Java environment. 
Background of the Invention 

In many software systems today, the existing or legacy graphical user 
interfaces ("GUIs") are coded in C++ code. Over the past few years, however, 
Java® has become the programming language of choice. In order to use Java for 
it) providing the functionality of a system, the C++ GUIs must be made useable with 

1 1 Java. One alternative is to rewrite all of the lines of C++ code in Java. Rewriting 

12 . the C++ code may comprise rewriting many lines of code. In many situations this is 
1 1 impractical. Furthermore, in many situations, it is desirable, practical, and cost- 

14 effective to maintain the C++ GUIs, instead of replacing them, and to use them to 

1 5 interface Java objects and methods of the Java functional code. 

1 5 Accordingly, another alternative is to enable the C++ GUIs to make calls 

17 directly to the Java objects and methods in a Java Virtual Machine ("JVM") in the 

1 3 Java environment. The Java objects and methods control the functions of the 
19 computer systems. In order for the C++ GUIs to make calls directly to the Java 

2 3 objects and methods in the JVM, the C++ GUIs must make Java Native Interface 

2 1 ("JNI") Application Programming Interface ("API") calls across the Java to legacy 

2 2 boundary, as conceptually shown in Figure 1 . Likewise, Java data types must be 

2 J converted to C++ data type, and vice- versa. 

24 A solution to this requirement comprises coding JNI APIs and data type 

2 5 conversions into each of the C++ GUIs as required. This is disadvantageous 

2 5 because it litters or clutters the legacy C++ GUIs with the JNI API and data type 

2 7 conversion coding, bloating the size of the C++ GUIs and causing future 

2 3 maintenance problems. Moreover, many of the JNI APIs are repetitious among the 

2 ? C++ GUIs. Therefore, coding the JNI APIs into each of the C++ GUIs is 

3 3 inefficient. Additionally, when the C++ code is converted to Java, the JNI APIs 

3 1 must be deleted, as they will be unnecessary when the former C++ GUIs are on the 

3 2 Java side of the JNI. 
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jl Summary of the Invention 

2 The present invention comprises a system and method for enabling the 

3 efficient accessing of Java objects and methods by legacy C++ GUIs. A base proxy 

4 object according to the present invention encapsulates the JNI APIs necessary for 

5 calling the Java methods in order to manipulate the Java objects. The base proxy 

6 object also comprises the necessary mapping mechanism for converting Java data 

7 types to C++ data types, and vice- versa. The JNI APIs and mapping mechanism are 
j} contained in general functions coded into the base proxy object. 

9 A method of efficiently accessing Java objects, classes and methods by 

10 legacy C++ GUIs according to the present invention comprises a C++ GUI 

1 1 obtaining a Java object, the base proxy object creating a C++ object that proxies the 

i 

12 Java object, the C++ GUI executing a callback that sends a request, via the C++ 

13 proxy object, to the base proxy object. The request comprises the Java object 

14 name, a class name, a method name, a C++ data type and, if setting a Java attribute, 

15 data of the C++ data type. The base proxy object processes the request and makes 

16 the necessary JNI API calls to pass it to the JVM. The base proxy object obtains the 

17 Java method ID, calls the Java object, class and method, and gets or sets the Java 

i 

1 8 attribute. If the callback gets an attribute, the base proxy object converts the 

19 retrieved Java attribute from the Java data type to the C++ data type and sends the 

20 converted attribute to the C++ proxy object. If the callback sets an attribute, the 

21 base proxy object converts the data from the C++ data type to the Java data type 

22 prior to sending the data through the JNI layer. 
2 3 Brief Description of the Figures 

2 4 The detailed description will refer to the following drawings, in which like 

25 numbers refer to like items, and in which: 

25 Figure 1 is a block diagram conceptually illustrating legacy C++ GUI 

2 7 interaction with Java objects in a Java Virtual Machine. 

2 8 Figure 2 is a block diagram of a computer system on which the present 

2 9 invention may be run. 

33 Figure 3 is a block diagram conceptually illustrating a base proxy object 

3 1 according to the present invention. 

32 Figure 4a is a static structure diagram of an embodiment of the base proxy 

3 3 object and interaction between C++ GUIs and Java objects according to the present 
3ft invention. 
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Figure 4b is a static structure diagram of an embodiment of C++ proxy 

2 object according to the present invention. 

8 Figure 5 is a flowchart of a method for creating a C++ proxy object 

<4 according to the present invention. 

i 

5 Figure 6 is a flowchart of a method of using the base proxy object to 

6 facilitate C++ GUI access to Java objects according to the present invention. 

j 

j7 Figure 7 is a sequence diagram illustrating the use of the base proxy object 

■8 according to the present invention. 

9 Detailed Description of the Invention 

i 

lp The present invention may be used with computer systems that utilize C++ 

1 jl graphical user interfaces ("GUIs") to access Java objects across a Java Native 

12 Interface ("JNI"). Figure 2 illustrates a computer network system with which the 

13 present invention may be used. The network system 10 comprises a ServiceControl 

i 

14 Manager ("SCM") 12 running on a Central Management Server ("CMS") 14 and 

15 one or more nodes 16 managed by the SCM 12 on the CMS 14. Together the one or 
IjS more nodes 16 managed by the SCM 12 make up a SCM cluster 17. A group of 

1|7 nodes 16 may be organized as a node group 18. 

1 18 The CMS 1 4 preferably is an HP-UX 1 1 .x server running the SCM 1 2 

19 software. The CMS 14 includes a memory (not shown), a secondary storage device, 

20 a processor, an input device (not shown), a display device (not shown), and an 

I 

2|1 output device (not shown). The memory, a computer readable medium, may 

22 include, RAM or similar types of memory, and it may store one or more 

i 

23 applications for execution by processor, including the SCM 12 software. The 

24 secondary storage device, a computer readable medium, may include a hard disk 

25 drive, floppy disk drive, CD-ROM drive, or other types of non- volatile data storage. 
2|s The processor executes the SCM 12 software and other application(s), which are 
2|7 stored in memory or secondary storage, or received from the Internet or other 

28 network 24, in order to provide the functions and perform the methods described in 

29 this specification, and the processing may be implemented in software, such as 

30 software modules, for execution by the CMS 14 and modes 16. The SCM 12 is 

3 1 preferably programmed in Java® and operates in a Java® environment that is 

32 preferably accessed by using legacy C++ GUIs and the present invention. See 

33 ServiceControl Manager Technical Reference, HP® part number: B8339-90019, 
available from Hewlett-Packard Company, Palo Alto, CA., which is hereby 
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incorporated by reference, for a more detailed description of the SCM 12. The 
ServiceControl Manager Technical Reference, HP® part number: B8339-90019 is 
also accessible at http://www.softv\ r are.hpxoni/products/scmgr . 

Generally, the SCM 12 supports managing a single SCM cluster 17 from a 
single CMS 14. All tasks performed on the SCM cluster 17 are initiated on the 

6 CMS 14 either directly or remotely, for example, by reaching the CMS 14 via a web 

7 connection 20. Therefore, a workstation 22 at which a user sits only needs a web 

8 connection 20 over a network 24 to the CMS 14 in order to perform tasks on the 

9 SCM cluster 17. The workstation 22 preferably comprises a display, a memory, a 

I 0 processor, a secondary storage, an input device and an output device. In addition to 

I I the SCM 12 software and the HP-UX server described above, the CMS 14 

1 2 preferably also comprises a data repository 26 for the SCM cluster 17, a web server 

1 3 28 that allows web access to the SCM 12 and a depot 30 comprising products used 

14 in the configuring of nodes, and a I/UX server 32. 

1 5 The nodes 1 6 are preferably HP-UX servers or other servers. The nodes 1 6 

1 6 may be referred to as "managed nodes" or simply as "nodes". Conceptually, the 

1 7 node 16 represents a single instance of HP-UX running on some hardware. The 

1 8 . node 1 6 may comprise a memory, a secondary storage device, a processor, an input 

1 9 device, a display device, and an output device. 

20 Although the CMS 14 is depicted with various components, one skilled in 

21 the art will appreciate that the CMS 14 may contain additional or different 

22 components. In addition, although aspects of an implementation consistent with the 

23 present invention are described as being stored in memory, one skilled in the art will 

24 appreciate that these aspects can also be stored on or read from other types of 

25 computer program products or computer-readable media, such as secondary storage 

26 devices, including hard disks, floppy disks, or CD-ROM; a carrier wave from the 

27 Internet or other network; or other forms of RAM or ROM. The computer-readable 

28 media may include instructions for controlling the CMS 14 (and/or the nodes 16) to 

29 perform a particular method, such as those described herein. 

3 0 Java objects operating in a JVM provide the functionality of the SCM 12. In 

3 1 the system 1 0, when a user, through a C++ GUI, wants to access the functionality of 

32 the SCM 12 {e.g., to create, retrieve, save, delete or modify persistent data (e.g., in 

33 the data repository 26) of the Java objects or to run a tool on a node(s) or node 

34 group(s)), the C++ GUI executes a callback that causes a particular Java class to be 
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instantiated, thus creating a particular Java object and a C++ object, that proxies the 
Java object. Java classes are meta-definitions that define the structure of a Java 
object. Java classes when instantiated create instances of the Java classes and are 
then considered Java objects. Methods within Java objects are used to get or set 
attributes of the Java object and to change the state of the Java object. 
Consequently, the C++ GUI may subsequently execute callbacks that execute 
methods on the proxy C++ object and that are processed by a base proxy object of 
the present invention to run the methods of the Java object to get or set attributes of 
the Java object, thereby creating, retrieving, saving, deleting or modifying data in 
the persistent store or running a tool on a node(s) or node group(s). 

1 1 Some of the objects and classes discussed herein are named with a prefix 

12 "mx". The mx prefix is indicative of the application utilizing the objects and 

1 3 classes (e.g., the SCM 12) and is merely exemplary. Indeed, the names of classes, 

14 objects and methods discussed herein are exemplary, are not intended to be limiting, 
1 5 and are merely used for ease of discussion. 

1 5 Figure 3 conceptually illustrates a base proxy object 40 and interactions 

1 7 between a C++ environment 42 and a JVM 48. For clearer understanding, the 

1 8 reference numbers used in Figure 3 are used throughout this specification. In the 

19 present embodiment, a base proxy object 40 is coded in the SCM 12 software and 

23 stored in the CMS 14. The base proxy object 40 is shown in a C++ environment 42, 

21 with one or more C++ GUIs 43 and one or more C++ proxy objects 44, separated by 

22 a JNI boundary 46 from the JVM 48 and one or more Java objects 50 that each 
2B comprise one or more methods. 

24 The C++ proxy objects 44 proxy the Java objects 50 and each C++ proxy 

25 object 44 is created when a C++ GUI 43 obtains a Java object 50, as described 

25 below. Accordingly, each C++ proxy object 44 includes methods that correspond 

27 to the methods of the Java object 50 that the C++ proxy object 44 proxies. The C++ 

28 proxy objects 44 also maintain names of the Java objects 50 that they proxy, 

29 identifying the Java classes that need to be instantiated to create instances of the 

3 0 Java objects 50. As is discussed below, when the C++ GUI 43 sends a request to a 

3 1 C++ proxy object 44 (i.e., executes a callback that executes a method on the C++ 

3 2 proxy object 44), the C++ proxy object 44 passes the method name, corresponding 

33 to the Java object 50 method name to the base proxy object 40. Each instance of a 

34 C++ proxy object 44, and the Java object 50 that the C++ proxy object 44 proxies, 
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will exist for the duration of execution of the C++ GUI 43 that obtained the Java 

2 object 50. 

3 Referring again to Figure 3, the base proxy object 40 hides the mechanics of 
using the JNI from C++ consumers (GUIs 43) of Java objects. By hiding these 

15 mechanics, the base proxy object 40 makes it appear to C++ GUIs 43 that the C++ 

6 GUIs 43 are interacting with and manipulating fully functional C++ objects 44 

7 when the C++ GUIs 43 execute callbacks to get or set attributes of the Java objects 

8 50 that the C++ objects 44 proxy. 

9 The base proxy object 40 is a base C++ class that provides a basic mapping 

10 mechanism. The C++ proxy objects 44 are sub-classes of the base proxy object 40. 

1 1 The base proxy object 40 preferably caches both Java Class IDs as well as Java 

12 Method IDs in order to minimize the number of C++ to Java Virtual Machine 

l(3 ("JVM") transitions. The base proxy object 40 preferably uses the C++ Standard 

14 Template Library (STL) to implement both the caching and "method name (Java) to 

15 method ID (Java)" mapping mechanisms. 

16 As described above, a JNI API call is required for a C++ GUI 43 to access a 

17 Java object 50 across the JNI boundary 46. The base proxy object 40 preferably 

18 includes the JNI API calls necessary to access Java objects 50 requested by all of 

19 the C++ GUIs 43. The JNI API calls are coded into general functions (functions 

20 and methods are used interchangeably herein with regards to C++ objects) in the 

21 base proxy object 40 that call a Java method to either get or set an attribute of a 

22 specific type in the Java object being accessed (for exemplary general functions, see 
2!3 Figure 4a). Coding the JNI API calls necessary to access Java objects 50 requested 

24 by all of the C++ GUIs 43 in the base proxy object 40 collects these JNI API calls 

25 in one class, instead of littering or cluttering each C++ GUI 43 with the JNI API 

26 calls necessary for that individual C++ GUI 43. 

27 Collecting the JNI API calls in the base proxy object 40 has a number of 

28 advantages: for example, since some JNI API calls would otherwise be used by 

29 more than one C++ GUIs 43, collecting them in the base proxy object 40 prevents 

30 unnecessary repetition, allows generalization (e.g., getting a user name is 

31 generalized as getting a String with a specific method call) and increases efficiency; 

32 and, the C++ GUIs 43 are kept streamlined, which is especially advantageous if the 

33 legacy C++ GUIs 43 are ever converted to Java. Conversion of the legacy C++ to 

34 Java may basically comprise the re- writing of C++ syntax to Java syntax; by 
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keeping the JNI API calls out of the C++ GUIs 43 and in the base proxy object 40, 
the base proxy object 40 and C++ proxy objects 44 may simply be removed when 
the legacy C++ is converted to Java. These and other advantages will become 
apparent throughout this specification. 

Java data types and C++ data types are different. Therefore, when accessing 
the JVM 48 through the C++ environment 42, as illustrated by Figure 3, it is 
necessary to map the Java data types to C++ data types. Accordingly, the base 
proxy object 40 comprises a mapping between Java data types and C++ data types. 
The mapping preferably used is shown in the following table: 



Java Data Type 


C++ Data Type 


String 


String 


boolean (Bool) 


bool 


long 


long long 


int 


long 


Array of int 


vector of long 


Array of object 


vector of proxy object 


Array of String 


vector of string 



Table 1 

The conversion according to this mapping is preferably coded into the base proxy 
object 40 general functions or methods, described above, that call a Java method to 
get or set an attribute of a specific type in the Java object being accessed. 

Referring back to Figure 3, the general interaction between the C++ GUIs 
43, C++ proxy objects 44, the base proxy object 40 and the Java objects 50 is 
shown. Assuming that a C++ proxy object 44 proxying a Java object 50 has already 
been created (as described below), a C++ GUI 43 executes a callback that in turn 
executes a method on the C++ proxy object 44 (corresponding to a method of the 
proxied Java object 50) to get or set an attribute(s) in the proxied Java object 50. 
The C++ proxy object 44 passes control through the GUI callback to the base proxy 
object 40 as a method call with arguments including a Java object name, a class 
name, a method name(s), and the C++ data type of the output the C++ object 40 is 
getting or the input the C++ object 40 is setting. The Java object name, class name 
and method name(s) passed by the C++ proxy object 44 to the base proxy object 40 
identify the proxied Java object 50, the Java class that defines the structure of the 
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proxied Java object 50, and a method(s) of the Java object 50 that the C++ GUI 43 

2 needs to access. The base proxy object 40 processes the method arguments to 

3 access the Java object and to call the requested method(s) across the JNI boundary 

4 46. 

> In order to call a Java method across the JNI boundary 46, a method ID for 

3 the Java method is required. The method ID is a unique identifier associated with a 

7 Java method that is established when the Java class containing the Java method is 

8 initialized. The method ID retains its value until the Java class containing the 

9 method ID is unloaded. The base proxy object 40 obtains the method ID across the 
lb JNI boundary 46 using the method name provided by the C++ proxy object. When 

11 a C++ proxy object 44 is first created (as described below) the method IDs and class 

12 ID are preferably dynamically obtained as instance data from the Java objects 50 

13 and cached. When the method is subsequently called, the method ID may be 
li4 accessed from the cache without having to access the method ID via the JNI, 
15 thereby reducing the number of C++ to JVM transitions. The cache may be a 

lp method data hash table, wherein the method data comprises the method signature 

lp and the method ID. 

1-8 Accordingly, the base proxy object 40 preferably processes the method 

1|9 request by identifying the Java object 50 using the Java object name provided by the 

2?0 C++ proxy object 44, obtaining the method ID from the cache, and calling the Java 

21 object 50 and Java method(s) via the JNI 46, using the object name and method ID. 

22 If a set function is called, the base proxy object 40 will pass the input data supplied 
2b by the C++ GUI 43 to the Java object 50. 

^4 If the executed callback specifies a get function (/.e., returning an output 

25 from the Java object), the called Java method will return a Java data type output and 

26 the base proxy object 40 will convert the output to the C++ data type specified by 
2j7 the above mapping in Table 1. If the executed callback specifies a set function (z.e., 

28 sending input data to the Java object), the base proxy object 40 will convert the 

29 input data from a C++ data type supplied by the callback to the Java data type 

3|0 specified by the above mapping in Table 1 before sending the input data to the Java 

31 object 50. 

I 

3|2 Figure 4a is a static structure diagram that illustrates an exemplary 

3|3 embodiment of the base proxy object 40. The base proxy object 40 is a base 

34 implementation class labeled 'MxProxy' in Figure 4a. The base proxy object 40 
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comprises the following data variables 401 : myJNIEnv, a JNI environment pointer 
obtained from an Object Action Manager ("Ob AM") (alternatively, the JNI 
environment pointer may be obtained directly from JNI API calls); myJavaObject, a 
Java object reference to the Java object proxied by the C++ object 44 currently sub- 
classing the base proxy object 40; myJavaClass, a Java class reference to the 
proxied Java class; myClassName, the name of the proxied Java class; and, 
myMethodData, for accessing the method data hash table (containing the method 
IDs and signatures) for the proxied Java class. The Java object reference and the 
name of the proxied Java class are preferably provided by the C++ GUI 43 when it 
instantiates the C++ proxy object 44. 

The base proxy object 40 also comprises base proxy object functions or 
methods 402 and the general functions or methods 403 mentioned above. The 
parameters of the functions 402 and 403 are shown within the parenthesis and the 
returned data or data type is shown after the colon. The base proxy object functions 
402 include a constructor (init), a copy constructor (MxProxy), and getJavaObject, 
get ClassName, getJniEnv and getMethodID functions. The constructor is used to 
initialize the C++ proxy objects and is called by the C++ object constructors called 
below. The copy constructor is used to copy the C++ proxy objects if the C++ 
proxy objects are stored in vectors. The getJavaObject function returns the proxied 
Java object reference from the myJavaObject variable 401 so that it may be passed 
to the JVM. The getClassName function is used to return the Java class name from 

i 

| 

the myJavaClass variable 401 . The getJniEnv function returns the JNI environment i 
pointer returned from a call to ObamGetJNIEnv() or an appropriate JNI API call; j 
the current JNI environment pointer is retrieved in order to make a call to the JNI 
API. The getMethodID provides a protected method for acquiring a method ID ! 
from an instantiated class (e.g., the proxied Java class). j 
The general functions 403 call a Java method to get or set an attribute of a j 
specific type in the Java object being accessed. The inventors realized that getting < 
or setting attributes of any Java object generally meant getting or setting a data of a 
particular data type by running a particular method. For example, the function 
getString(in methodName: string &): string *, will return a pointer to a C++ STL ! 
string using the method identified by methodName, which is a string provided by \ 
the C++ proxy object 44, and return a pointer to a C++ string. As an example, , 
assuming a C++ proxy object 44 MxUser with a method name called j 



HP 10006054 



getUserName(): string *, a C++ GUI callback method invocation comprising the 
name call getUserName(): string * will be executed as a getString with 
getUserName as the methodName. The getString(getUserName) will retrieve a 
String from the Java method getUserName and convert the String to a C++ string 
for output to the C++ proxy object 44 and to the C++ GUI 43. 

Figure 4a also illustrates some of the C++ proxy objects 44 that are sub- 
classes from the base proxy object. The C++ proxy objects 44 are not created until 
a C++ GUI 43 (not shown in Figure 4a) obtains a Java object 50 (not shown in 
Figure 4a). However, the constructor functions (i.e., Mx{object}) that create the 

10 C++ proxy objects 44 and the methods (e.g., +setName(in toolName: string &)) that 

1 1 the C++ proxy objects 44 comprise are pre-coded (e.g., as part of the SCM 12 

12 software). For example, MxTool is a C++ proxy object 44 that proxies a Java 

13 object 50 of the same name. MxTool is created when a C++ GUI 43 obtained an 

I 

1 jl empty Java object 50 MxTool according to the process described below. For each 

1 5 instance of Java object 50 MxTool, there will be a corresponding C++ proxy object 

1 j) 44 MxTool. Consequently, each time a C++ GUI 43 creates a new tool or wishes to 

lj7 modify (e.g., change or delete) an existing tool, a Java object 50 MxTool and C++ 

18 proxy object 44 MxTool will be created and exist for the duration of execution of 

1*9 the C++ GUI 43. 

20 In a preferred embodiment, a plurality of Java objects 50 provide 

21 functionality for a computer system. Related to the Java objects 50 are a 

j 

22 corresponding number of C++ proxy objects 44 that proxy the Java objects 50. In 

2;3 the computer network system 10 illustrated in Figure 2, the SCM 12 includes the 

l 

2|4 following C++ proxy objects 44 proxy ing Java objects 50 with the same name: 

2;5 MxUser, MxUserName, MxNode, MxNodeName, MxIPAddress, MxNodeGroup, 

2£ MxNodeGroupName, MxTool, MxToolName, MxToolGroupName, 

I 

2i7 MxToolToolGroupPair, MxFileCopyPair, MxParameter, MxRunnableTool, 

i 

28 MxTaskStatus, MxTargetStatus, MxTargetOutput, MxAuthorization, MxRole, 

2j9 MxRoleName, MxString. Consequently, C++ GUIs 43 may access all of the Java 

30 objects 50 with the above names, through the corresponding C++ proxy objects 44 

3 1 and the base proxy object 40. 

32 A method data hash table 404 (e.g., MxMethNameToMethData) is also 

33 shown in Figure 4a. MxMethNametoMethData is an object that is a data member in 

34 the C++ base proxy class 40. Initially, MxMethNametoMethData is an empty hash 
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table 404. Each C++ proxy object 44, such as MxNode, preferably has a method 
info array (e.g., an array methodlnfot object) that is a subset of data that goes into 
the MxMethodNametoMethData hash table 404. The methodlnfo _t data preferably 
contains the method name and signature. Preferably, the methodInfo_t data does 
j> not include the method ID, since this is obtained dynamically, as described herein. 

6 The methodInfo_t data is placed inside the hash table 404 in order to provide fast 

7 and efficient access to the methodInfo_t data. 

3 As implied by the name MxMethNameToMethData, the method name is the 

9 key to the hash table 404 and the methodInfo_t data is retrieved from the hash table 

10 404 simply by using the method name. If the methodlnfo_t data were left as an 

Ijl array, this array would have to be linearly searched to locate the correct data. The 

12 methodInfo_t data is entered into the hash table 404 by passing the methodInfo_t 

IS object to the MxMethNameToMethData object and asking the 

lj4 MxMethNameToMethData object to populate itself with the passed methodInfo_t 

15 object. 

i 

l|6 Figure 4b illustrates an exemplary C++ proxy object 44, MxTool, including 

li7 MxTooFs constructor function and get/set functions. Other C++ proxy objects 44 

18 likewise comprise a constructor function and get/set functions. As shown in the 

19 static structure diagram in Figure 4b, MxTool comprises methods 441 for creating 

20 and modifying tools that are used in the network system 10 and with the SCM 12 



2|1 described above. To create a tool, a C++ GUI 43 issues a request with the 

22 appropriate user-entered data (e.g., tool name, created by, created time (e.g., as 

J 

23 determined by the network system 10), description, etc.) as the method parameters 

24 (in the parenthesis) to the MxTool C++ proxy object 44. The executed C++ GUI 43 
2*5 callback makes the necessary method calls (e.g., setName(in toolName: string &), 
2^ setCreatedBy(in creatorlD: long), set CreatedTime(in milliseconds: long long), 

27 setDescription(in description: string&), etc.), on the MxTool C++ proxy object 44 

28 that have the effect of calling the proxied Java object 50 through the base proxy 

29 object 40. The base proxy class 40 processes the method request(s) and makes the 

30 necessary JNI API calls, sending the appropriate Java methodlDs and making the 

3 ; 1 appropriate data type conversions. Other C++ GUI 43 method calls (requests) to the 

32 other C++ proxy objects 44 work in a similar manner. 

33 Another advantage of the base proxy object 40 of the present invention is 
that it is customizable. Since it is customizable, the base proxy object 40 may be 
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used in any system in which a C++ to Java transition similar to that described above 
takes place. The base proxy object 40 may be customized by adding or removing 
base proxy object functions 402 or general functions 403. For example, the base 
proxy object 40 shown in Figure 4a does not include getting or setting of floats. If a 
particular system required the getting or setting of floats, getFloat and/or setFloat 
functions could be added to the base proxy object 40. Likewise, additional or 
different the C++ proxy objects 44 may be implemented to mirror additional or 
different Java objects 50, as determined by the particular needs of the computer 
system (e.g., network system 10) with which the invention is used. 

Figure 5 illustrates a method 60 for creating a C++ proxy object 44 
comprising a C++ GUI 43 obtaining a Java object 62, initiating C++ proxy object 
linkage to the Java object 64 and passing instance data to the base proxy object 66. 
The obtaining step 62 may comprise instantiating a Java class to create a Java object 
50 in the JVM 48. The C++ GUI 43 may accomplish this via a JNI call that returns 
a Java object (e.g., GetObject Array Element) or via a call to an Objectifier. The 
Objectifier is a Java object that is a mapping layer that maps C++ procedural code 
to Java object-oriented classes and that creates new Java objects based on 
procedural calls from C++ GUIs 43, among other things. 

When the new Java object is obtained, the JNI environment pointer, Java 
object name and Java class name are returned as a call to the C++ environment 42, 
therefore executing a constructor function to create and link a C++ proxy object 44 
to the Java object 50. Accordingly, the initiating C++ proxy object linkage to the 
Java object 64 may comprise calling the appropriate constructor function with the 
JNI environment pointer, Java object name and Java class name as parameters to 
create and link a C++ proxy object 44 to the new Java object 50. For example, a 
call comprising the Java object name MxUser will execute a constructor that creates 
a C++ proxy object 44 of the same name (MxUser). The new C++ object MxUser 
will be linked, and therefore will proxy, the Java object MxUser. 

When created, the new C++ proxy object 44 calls a constructor in the base 
proxy class 40 to initialize the instance data and to create global references for the 
proxied Java object 50. Therefore, the passing instance data to the base proxy 
object 66 may comprise the new C++ proxy object 44 calling the init function in the 
base proxy object and passing the JNI environment pointer, the Java object name 
and the Java class name with the init call (see Figure 4a). The method 60 may also 
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comprise a step of populating a method name to method date hash table 68. The 
hash table links method names with method data (e.g., method signature). The 
populating step 68 preferably comprises the new C++ proxy object 44 passing 

4 method names and method data to the hash table 404. The method names and 

5 method data are instance data of the new C++ proxy object 44. As noted above, 
<j> maintaining the method data in the hash table 405 enables easier access to the 

7 method data by the base proxy object 40 and reduces the number of JNI API calls 

8 necessary. 

9 After a Java object 50 and its proxy, the C++ object 44, have been created, 

10 the C++ GUI 43 can get/set attributes in the Java object 50, through the C++ proxy 

1 1 object 44 and the base proxy object 40. Figure 6 illustrates a method 70 for 

12 getting/setting attributes in the Java object 50. The method 70 corresponds to the 

13 general interaction between the C++ GUIs 43, C++ proxy objects 44, the base proxy 
lh object 40 and the Java objects 50 shown in Figure 3 and described above. The 

1 p method 70 comprises a C++ GUI issuing a request to a C++ proxy object 72, the 

15 C++ proxy object passing method data to the base proxy object 74, the base proxy 

1 7 object processing the method data 76 and the Java object executing a Java method 

1 i 78. The method steps may be performed as described above with reference to 

1 9 Figures 3, 4a and 4b and as illustrated by the exemplary sequence diagram 

2 3 described below. 

2 1 Accordingly, issuing a request to a C++ object 72 preferably comprises the 

2 2 C++ GUI 43 invoking a method call on the C++ proxy object 44 and providing the 

2 J user entered data as the necessary parameters of the invoked C++ proxy object 44 

24 method. The invoked C++ proxy object 44 method corresponds to the Java object 

25 50 method that needs to be invoked to get or set attributes of the proxied Java object 
25 50. 

2 7 Passing method data to the base proxy object 74 preferably comprises the 

28 C++ proxy object 44 processing the method call invoked by the C++ GUI 43 and 

29 calling a base proxy object 40 method. The C++ proxy object 44 includes the 

3 D method data (e.g. , Java method name and the user entered data) in the base proxy 

3 1 object 40 method call. The C++ proxy object 44 method invoked by the C++ GUI 

32 43 determines the base proxy object 40 method called. For example, a common 

33 C++ proxy object 44 method, setCreatedBy(const long uid):void, invoked by the 
3 4 C++ GUI 43 to set the uid of a created Node, User, Tool, etc., will call the base 
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proxy object 40 method setInt(const string & methodName, const long cpplnt): void 

2 when processed, since a uid has a C++ data type long that maps to Java data type Int 

?> (as seen in Table 1 above). Consequently, setting the Creating By attribute is 

' i- basically setting a Java int. 

5 Processing the method data 76 preferably comprises the base proxy object 

6 40 executing the called method, getting the Java method ID using the method name 

7 provided by the C++ proxy object 44, issuing necessary JNI API calls with the 
i method ID to call the Java method indicated by the method ID, and converting C++ 
9 data to Java data (and vice-versa). Executing a Java method 78 preferably 

10 comprises a Java object 50, which is proxied by the C++ object 44, executing the 

1 i Java method called by the base proxy object 40 and identified by the method ID. If 

12 the Java method is a get method, the Java object 50 returns a pointer to the C++ data 

13 79. 

14 Figure 7 is a sequence diagram detailing an exemplary process according to 

1 5 the present invention utilizing the base proxy object 40 to get and set attributes of a 
1 5 Java object 50 via a C++ GUI 43. The sequence diagram illustrates boxes 
1 7 representing an MxNewNode (a C++ GUI 43) 90, an MxObjectifier 92 (the 
1 8 Objectifier described above), a MxNode (a C++ proxy object 44) 94, a MxProxy 

1 9 (the base proxy object 40) 96, a JNI (the JNI boundary 46) 98 and a 

20 MxMethNameToMethData 100 (the method data hash table 405 discussed above). 

21 The representative boxes 90-100 are shown with vertical time-lines 102 running 

22 from the boxes 90-100 and horizontal call lines 104 running from the appropriate 

23 initiating GUI, object, etc. time-line 102 to the appropriate target object, layer, map, | 

24 etc. time-line 102. The horizontal call lines include a method, with the method 

25 parameters within parenthesis and the returned data following a colon. The vertical 

26 position of the call lines 104 indicates their sequential order of initialization and 

27 execution. The length of the vertical time-line 102 indicates the period of execution 

28 of the GUI, object, layer, map, etc. represented by the box 90-100 from which each 

29 time-line 102 descends. Also shown are notation boxes 106 that comprise various 

30 comments. The sequence diagram of Figure 7 is described below moving left to 

3 1 right and top to bottom. 

32 In the exemplary process shown, the MxNewNode box 90 represents a C++ 
3 3 GUI 43 that may be used to enter data to create a new node in the network system 
34 10. As seen in Figure 7, the MxNewNode GUI 43 issues a call (shown by the 
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getNode():j object call line 104) to obtain a Java object 50. As noted above, a C++ 
GUI 43 may obtain a Java object 50, for example, via a JNI call that returns a Java 
object or via a call to the Objectifier. In the present example, as noted by the 
associated notation 106, the MxNewNode GUI obtains the Java object 50 via a call 
to the Objectifier (represented by MxObjectifier box 92). A new, empty MxNode 
Java object 50 is thus created in the JVM 48. 

The Objectifier returns the new, empty MxNode Java object 50 as a call to 
the C++ environment 42. This call is illustrated by the MxNode(JNIEnv * 
envjobject javaObject,const string & className) call line 104 extending from the 
10 MxNewNode 90 vertical time-line 102 to the MxNode 94 time-line 102. If the Java 

1 I object 50 were returned by a JNI call, or in another manner, the Java object 50 

1 I would also be returned to the C++ environment 42 as a call. As noted by the 

1 5 associated notation 106, the MxNode call initiates C++ proxy object 44 linkage by 

14 calling the appropriate constructor function (i.e., MxNode) in the C++ environment 
1 > 42. With the parameters provided within the parenthesis, the MxNode call links the 

15 new MxNode C++ proxy object 44 to the new MxNode Java object 50. 

1 7 The MxNode box 94 represents the new MxNode C++ proxy object 44 

1 3 created by the MxNode call. The new MxNode C++ proxy object 44 issues a call to 

1 ? . the base proxy class 40 invoking a function in the base proxy class 40 (i.e., the init 

2 ) function) to initialize the instance data and to create global references for the 
2 1 proxied Java object 50. This function call is shown by the init(JNIEnv * env, 
2 2 jobject javaObject, const string & className): void call line 104. The ":void" 
2 3 indicates that the method call returns a void (i.e., nothing). The env is the JNI 
2 1 Environment pointer obtained from ObAM or directly via a JNI API call (as - 

2 5 discussed above), the javaObject reference is the Java object reference obtained by 

2 5 the GUI (e.g., from the Objectifier) and the className is the name of the proxied 

2 7 Java class also provided by the GUI. 

2 3 As noted above, the init function initializes the instance data and creates 

2 ? global references for the proxied Java object 50 and class. Accordingly, the base 

3 3 proxy object 40, represented by the MxProxy box 96, issues appropriate JNI API 

3 1 calls that are coded into the init function. These JNI API calls are illustrated by the 

3 2 NewGlobalRef(jobject):jobject, FindClass(string):jclass, and NewGlobalRef(j class): 

3 3 jclass call lines 104. The NewGlobalRef call passes the jobject reference included 

3 % in the init function call. The FindClass call passes the className string included in 
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the init function call. The NewGlobalRef call passes the jclass reference obtained 
by the FindClass call. 

Once the instance data is initialized and global references are created, the 

new MxNode C++ proxy object 44 issues a call to populate the method data hash • 

i 

table 405 (represented by the MxMethNametoMethData box 1 00) with the method j 

i 

data from the proxied Java class. The method data includes a count (methodCount) i 
of the number of methods in the methodlnfot array and a pointer (methodInfo_t* ) \ 

to the methodInfo_t array. The methodInfo_t array includes the method name and ! 

! 

signatures. The C++ proxy object 44 issues this call since the method data , method j 

lp names, and method signatures are embedded as instance data in the C++ proxy j 

i 

1 1 object 44 and the method data hash table 405 is preferably visible to all base proxy * 

1 2 object 40 sub-classes. This call is illustrated by the populate(const int j 

» 

1 3 methodCount, const methodInfo_t* const & methodInfo):void call line 104. As j 

i 

1 4 noted above, the method name is used as a key to access the method data populated j 

1 5 in the hash table 405. ! 

1 6 After the above steps are executed, the C++ GUI 43 may issue a method j 

1 7 execution request to set the name of the Java object 50, as shown in Figure 7. This 

1 8 request is illustrated by the setName(const string & nodeName): void call line 104 

1 9 extending from the MxNewNode vertical time-line 102. The setName request is j 

20 passed to the MxNode C++ object 44. The string in the request is the name of the J 

21 MxNode Java object 50 created above that is to be set. 

22 The MxNode C++ proxy object 44 passes the request to the base proxy 

23 object 40. The setString method of the base proxy object (see Figure 4a above) is 

24 preferably used to set the name of the Java object 50, since the setString method 

25 makes calls on the proxied Java object 50. To set the name of the node, an 

26 MxNodeName object 50 is preferably instantiated. Therefore, the method data (i.e., 

27 method name and Java class ID for the MxNodeName Java object 50) is passed to 

28 the base proxy object 40 via a setNameObject call, shown by the 

29 setNameObject(const string & methodName,const string & classPath,const string & 

30 name): void call line 104. The setNameObject call causes the setNameObject 

3 1 method in the base proxy object 40 to be executed. 

32 Consequently, the setNameObject method comprises getting a method ID 

33 for the method of the MxNode Java object 50 that sets the name attribute of the 

34 MxNode Java object 50 and creating a new Java name object from the string 
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specified in the C++ GUI setName method request by calling the Java method that 
sets the name attribute with the new Java name object. 

The getMethodID and GetMethodID call lines 104 show the getting a 
method ID step. The first time getting a methodID, the base proxy object 40 gets 
the method ID by crossing the JNI boundary 46 using the proxiedjava class ID, the 
methodName string and the method signature, all provided by the C++ proxy object 
44. Subsequently, the methodID is cached in the method data hash table, from 
which it may be retrieved as needed. 

Referring to Figure 7, the base proxy object 40 first calls its own 



10 getMethodID method (as indicated by the self-referential getMethodID call line 104 

1 1 that indicates that MxProxy is the method initiator and target). The invoked 

12 getMethodID(string & methodName): jmethodID function calls the hash table 405 

13 (the MxMethNameToMethData object) using the method name as a key. This call 

14 retrieves a methodInfo_t object linked to the method name. The "getMethodID" 

1 5 function looks inside the methodInfo_t object and if it finds a non-null java method 

16 ID, then the method ID has already been obtained and the getMethodID function 

17 does not need to make the call to the JNI 46. The "cached" method ID is simply 
lj8 returned. If however, the java method ID is null, the getMethodID function makes 

19 the call to the JNI 46 and caches the returned ID in the methodInfo_t object, and 

20 then puts the methodInfo_t object back into the hash table 405 (the 

21 MxMethNameToMethData object) for later use if so requested. Then the 

22 getMethodID function returns the method ID to the caller. 

23 Consequently, Figure 7 illustrates the lookup (lookup(string 

2|4 key javaMethodData_t & retValue) : bool ), the JNI call (GetMethodID(j class 

2|5 clazz,const char * methodName,const char * signature) : jmethodID) and the put 

2j6 back of the methodInfo_t object (putBack(string key JavaMethodDate_t & 

2|7 refValue) : bool) since the method ID has not been previously retrieved and cached. 
2j8 The newNameObject(const string & javaClassPath, const string & 

29 name):jobject is a self-referential method that calls the constructor of a Java name 

30 object (e.g., MxNodeName) that takes the Node name string provided by the C++ 

31 GUI 43 and returns a Java object global reference, j object, to the constructed Java 

32 name object. The newNameObject method converts the C++ string provided by the 

33 C++ GUI 43 to a Java string, finds the method ID of the Java name object 

34 constructor, invokes the constructor to create the Java name object and creates a 
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global reference to the new Java name object (not shown in Figure 7). The 
CallVoidMethod calls the Java method that sets the name of the MxNode Java 
object 50. As shown, the parameters include the global reference of the MxNode 
Java object 50 (i.e., the first j object), the Java method ID, {i.e., the jmethodID), and 
the global reference of the Java name object MxNodeName (i.e., the second 
jobject). The CallVoidMethod is the JNI API call to the JVM, in which the method 
identified by the jmethodID (i.e., the method of the MxNode Java object 50 that sets 
the name attribute of the MxNode Java object 50) is called. Once the name of the 
MxNode Java object 50 has been set, the global reference of the Java name object 
MxNodeName is no longer needed. Accordingly, the base proxy object issues a 
DeleteGlobalRef(jobject) call to delete the jobject global reference of the Java name 
object MxNodeName. 

Once the Java object 50 and its proxy, the C++ object 44, have been created, 
1(4 the C++ GUI may get/set attributes of the Java object 50. Again referring to Figure 

1 5 7, the MxNewNode GUI 90 issues a method call to set the created by attribute of 

16 the Java object 50. This method call is shown by the setCreatedBy(const long 

17 uid):void call line 104. Therefore, this calls the setCreatedBy function in the 
8 MxNode C++ object 44, passing a C++ long user id (uid). 

Since a C++ long is mapped to a Java int, the MxNode C++ proxy object 44 

20 passes the parameter to the base proxy object 40 by calling a setlnt function. This is 

21 shown by the setInt(const string & methodName, const long cpplnt): void call line 
2j2 104. As seen, the setlnt call includes a string for the method name and the C++ 

23 long for the Java Int as parameters. In this example, the method name is 

24 MxNode.setCreatedBy (i.e., the MxNode Java object 50 method that sets the uid 

25 (userid) identifying the user that created the node object). 

26 When received by the base proxy object 40, the setlnt method gets the 

27 method ID of the method in the MxNode Java object 50 that sets the setCreatedBy 

28 attribute. Once the method ID (jmethodID) is returned (by the self-referential 

29 getMethodID method call shown), the base proxy object calls the method, passing 

30 the method ID and the long uid (converted to a java Int j int) to the MxNode Java 

31 object 50. This is illustrated by the Call VoidMethod(j object jmethodID jint) call to 

32 the JNI. The jobject parameter is the global reference to the MxNode Java object 

33 50. 
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While the invention has been described with reference to the exemplary 
embodiments thereof, those skilled in the art will be able to make various 
modifications to the described embodiments of the invention without departing from 
the true spirit and scope of the invention. The terms and descriptions used herein 
are set forth by way of illustration only and are not meant as limitations. Those 
skilled in the art will recognize that these and other variations are possible within 
the spirit and scope of the invention as defined in the following claims and their 
equivalents. 
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What is claimed is: 

1 . A computer system that enables the efficient accessing of Java objects and 
methods by C++ graphical user interfaces, the computer system comprising: 

a processor that runs a software program, wherein the software 
program generates: 

a Java Virtual Machine; 

7 a Java Native Interface ("JNI") boundary; and 

8 a C++ environment, wherein a JNI application programming 
p interface ("API") call across the JNI boundary is required to access 

10 the Java Virtual Machine from the C++ environment, the C++ 

1 1 environment comprising: 

12 a graphical user interface, wherein the graphical user 

13 interface comprises callback code that is executed to issue 

14 one or more method requests; and 

15 a base proxy object, comprising one or more functions 

16 that encapsulate one or more JNI API calls necessary to call a 

1 7 Java method in the Java Virtual Machine based on the one or 

1 8 more method requests of the graphical user interface. 
19 

20 2. The computer system of claim 1 , wherein the Java Virtual Machine 

21 comprises: 

22 a Java object, comprising: 
2j3 an attribute; and 

24 one or more methods that are executed to enter, retrieve or 

25 modify the attribute; and 

26 wherein the base proxy object makes the one or more JNI API calls 

27 across the JNI boundary to call the one or more methods of the Java object 

28 based on the one or more method requests of the graphical user interface. 
29 

30 3. The computer system of claim 2, wherein the C++ environment further 

3 1 comprises: 

32 a C++ proxy object that proxies the Java object, the C++ proxy 

33 object comprising: 
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1 one or more methods that correspond to the one or more 

2 methods of the Java object and that call one or more functions of the 

3 base proxy object when executed, wherein the one or more methods 

4 of the C++ proxy object are executed in response to the one or more 

5 method requests of the graphical user interface. 
6 

7 4. The computer system of claim 3 5 wherein the C++ graphical user interface 

8 executes for a finite length of time and the C++ proxy object and the Java object ! 

9 exist in the C++ environment and the Java virtual machine during the C++ graphical i 
10 user interface execution. '. 
11 

12 5. The computer system of claim 3, wherein the Java object is an instance of an 

1 3 instantiated Java class and the C++ proxy object is created as a result of the j 

14 instantiation of the Java class. I 

15 ! 

16 6. The computer system of claim 5, wherein the C++ proxy object includes 

17 instance data that identifies the Java object and locates the Java object in the Java 

1 8 virtual machine and wherein the instance data is passed from the Java virtual 

19 machine to the C++ proxy object when the C++ proxy object is created. 
20 

21 7. The computer system of claim 3, wherein the C++ proxy object includes one 

22 or more method names that name the one or more methods of the Java object and 

23 wherein the C++ proxy object passes the one or more method names to the base 

24 proxy object when calling the one or more functions of the base proxy object. 
25 

26 8. The computer system of claim 7, wherein one or more method IDs identify 

27 the one or more methods of the Java object and the base proxy object retrieves the 
2 8 one or more method IDs using the one or more method names provided by the C++ 
29 proxy object. 
30 

31 9. The computer system of claim 8, wherein the base proxy object passes the 

32 one or more method IDs to the Java virtual machine when making the one or more 

33 JNI API calls across the JNI boundary to call the one or more methods of the Java 

34 object. 
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10. The computer system of claim 8, wherein the base proxy object caches the 
one or more method IDs in a C++ hash table that is accessible by the C++ proxy 
objects and the base proxy object. 

1 1 . The computer system of claim 2, wherein the Java object is one of the 
following: a user object, for adding or modifying a user; anode object, for adding or 

3 modifying a node; a node group object, for adding or modifying a node group; a 

9 tool object, for adding or modifying a tool; and a role object, for adding or 

1 0 modifying a role. 

11 

12 12. The computer system of claim 1, wherein the base proxy object further 

13 comprises a mapping mechanism for mapping Java data types to C++ data types. 

ij* 

15 13. A method for efficient accessing of Java objects and methods by C++ 

16 graphical user interfaces, the method comprising: 

17 a C++ graphical user interface issuing a method request to a C++ 

18 proxy object; 

1 9 the C++ proxy object passing method data to a base proxy object 

20 based on the method request; 

21 the base proxy object processing the method data; and 

22 a Java object executing a Java method based on the processed 

23 method data. 
24 

25 14. The method of claim 1 3, further comprising, if the executed Java method is 

26 a get method, returning a pointer to C++ data. 
27 

28 15. The method of claim 13, wherein the C++ proxy object includes one or more 

29 methods and the C++ graphical user interface issuing a method request to a C++ 

30 proxy object comprises executing callback code that invokes a C++ proxy object 

31 method. 
32 

33 16. The method of claim 13, wherein base proxy object includes one or more 

34 functions and the C++ proxy object passing method data to a base proxy object 
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based on the method request comprises processing the method request and calling a 
base proxy object function, wherein the base proxy object function call includes 
method data. 

17. The method of claim 16, wherein the base proxy object processing the 
method data comprises: 
7 executing the called base proxy object function; 

j8 getting a method ID based on the method data; and 

'9 issuing JNI API calls with the method ID to call the Java method. 

10 

11 18. The method of claim 13, further comprising: 

lj2 obtaining the Java object via a JNI API call, wherein the Java object 

13 instance data is passed through a JNI; and 

i 

14 initiating C++ proxy object linkage to the Java object, wherein the 

15 Java object instance data is used to create the C++ proxy object. 
16 

1|7 19. A computer readable medium containing instructions for enabling the 

lj8 efficient accessing of Java objects and methods by non-Java graphical user 

19 interfaces, by: 

20 a non-Java graphical user interface issuing a method request to a 

21 non-Java proxy object; 

22 the non-Java proxy object passing method data to a base proxy object 

23 based on the method request; 

24 the base proxy object processing the method data; and 

25 a Java object executing a Java method based on the processed 

26 method data. 
27 

28 20. The computer readable medium of claim 19, wherein the non-Java graphical 

29 user interfaces are C++ graphical user interfaces. 
30 
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ABSTRACT 

A system and method for enabling the efficient accessing of Java objects and : 
methods by legacy GUIs is disclosed. The system and method provide a base proxy j 
object that encapsulates the JNI APIs necessary for calling Java methods across the j 
JNI boundary. Legacy proxy objects proxy the Java objects and enable legacy GUIs 
to issue method requests as if the legacy proxy objects were fully functional objects. 
The legacy proxy objects receive method requests from the GUIs and call base 
proxy object methods that in turn make the necessary JNI API calls to call Java 
methods. 
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